home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / X11 / xpr.z / xpr
Encoding:
Text File  |  2002-10-03  |  18.8 KB  |  397 lines
  1.  
  2.  
  3.  
  4.      XXXXPPPPRRRR((((1111))))              XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))               XXXXPPPPRRRR((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xpr - print an X window dump
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           xxxxpppprrrr [ ----ddddeeeevvvviiiicccceeee _d_e_v_t_y_p_e ] [ ----ssssccccaaaalllleeee _s_c_a_l_e ] [ ----hhhheeeeiiiigggghhhhtttt _i_n_c_h_e_s ]
  13.           [ ----wwwwiiiiddddtttthhhh _i_n_c_h_e_s ] [ ----lllleeeefffftttt _i_n_c_h_e_s ] [ ----ttttoooopppp _i_n_c_h_e_s ] [ ----hhhheeeeaaaaddddeeeerrrr
  14.           _s_t_r_i_n_g ] [ ----ttttrrrraaaaiiiilllleeeerrrr _s_t_r_i_n_g ] [ ----llllaaaannnnddddssssccccaaaappppeeee ] [ ----ppppoooorrrrttttrrrraaaaiiiitttt ] [
  15.           ----ppppllllaaaannnneeee _n_u_m_b_e_r ] [ ----ggggrrrraaaayyyy ] [ ----rrrrvvvv ] [ ----ccccoooommmmppppaaaacccctttt ] [ ----oooouuuuttttppppuuuutttt
  16.           _f_i_l_e_n_a_m_e ] [ ----aaaappppppppeeeennnndddd _f_i_l_e_n_a_m_e ] [ ----nnnnooooffffffff ] [ ----sssspppplllliiiitttt _n ] [
  17.           ----ppppssssffffiiiigggg ] [ ----ddddeeeennnnssssiiiittttyyyy _d_p_i ] [ ----ccccuuuuttttooooffffffff _l_e_v_e_l ] [ ----nnnnooooppppoooossssiiiittttiiiioooonnnn ]
  18.           [ ----ggggaaaammmmmmmmaaaa _c_o_r_r_e_c_t_i_o_n ] [ ----rrrreeeennnnddddeeeerrrr _a_l_g_o_r_i_t_h_m ] [ ----sssslllliiiiddddeeee ] [
  19.           _f_i_l_e_n_a_m_e ]
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           _x_p_r takes as input a window dump file produced by _x_w_d(_1) and
  23.           formats it for output on PostScript printers, the Digital
  24.           LN03 or LA100, the IBM PP3812 page printer, the HP LaserJet
  25.           (or other PCL printers), or the HP PaintJet.  If no file
  26.           argument is given, the standard input is used.  By default,
  27.           _x_p_r prints the largest possible representation of the window
  28.           on the output page.  Options allow the user to add headers
  29.           and trailers, specify margins, adjust the scale and
  30.           orientation, and append multiple window dumps to a single
  31.           output file.  Output is to standard output unless ----oooouuuuttttppppuuuutttt is
  32.           specified.
  33.  
  34.           CCCCoooommmmmmmmaaaannnndddd OOOOppppttttiiiioooonnnnssss
  35.  
  36.  
  37.           ----ddddeeeevvvviiiicccceeee _d_e_v_t_y_p_e
  38.                Specifies the device on which the file will be printed.
  39.                Currently supported:
  40.                       llllaaaa111100000000
  41.                            Digital LA100
  42.                       lllljjjjeeeetttt HP LaserJet series and other monochrome PCL
  43.                            devices such as ThinkJet, QuietJet,
  44.                            RuggedWriter, HP2560 series, and HP2930
  45.                            series printers
  46.                       llllnnnn00003333 Digital LN03
  47.                       ppppjjjjeeeetttt HP PaintJet (color mode)
  48.                       ppppjjjjeeeettttxxxxllll
  49.                            HP HP PaintJet XL Color Graphics Printer
  50.                            (color mode)
  51.                       pppppppp   IBM PP3812
  52.                       ppppssss   PostScript printer
  53.  
  54.                The default is PostScript.  ----ddddeeeevvvviiiicccceeee llllwwww (LaserWriter) is
  55.                equivalent to -device ps and is provided only for
  56.                backwards compatibility.
  57.  
  58.           ----ssssccccaaaalllleeee _s_c_a_l_e
  59.                Affects the size of the window on the page.  The
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXPPPPRRRR((((1111))))              XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))               XXXXPPPPRRRR((((1111))))
  71.  
  72.  
  73.  
  74.                PostScript, LN03, and HP printers are able to translate
  75.                each bit in a window pixel map into a grid of a
  76.                specified size.  For example each bit might translate
  77.                into a 3x3 grid.  This would be specified by ----ssssccccaaaalllleeee _3.
  78.                By default a window is printed with the largest scale
  79.                that will fit onto the page for the specified
  80.                orientation.
  81.  
  82.           ----hhhheeeeiiiigggghhhhtttt _i_n_c_h_e_s
  83.                Specifies the maximum height of the page.
  84.  
  85.           ----wwwwiiiiddddtttthhhh _i_n_c_h_e_s
  86.                Specifies the maximum width of the page.
  87.  
  88.           ----lllleeeefffftttt _i_n_c_h_e_s
  89.                Specifies the left margin in inches.  Fractions are
  90.                allowed.  By default the window is centered in the
  91.                page.
  92.  
  93.           ----ttttoooopppp _i_n_c_h_e_s
  94.                Specifies the top margin for the picture in inches.
  95.                Fractions are allowed.
  96.  
  97.           ----hhhheeeeaaaaddddeeeerrrr _s_t_r_i_n_g
  98.                Specifies a header string to be printed above the
  99.                window.
  100.  
  101.           ----ttttrrrraaaaiiiilllleeeerrrr _s_t_r_i_n_g
  102.                Specifies a trailer string to be printed below the
  103.                window.
  104.  
  105.           ----llllaaaannnnddddssssccccaaaappppeeee
  106.                Forces the window to printed in landscape mode.  By
  107.                default a window is printed such that its longest side
  108.                follows the long side of the paper.
  109.  
  110.           ----ppppllllaaaannnneeee _n_u_m_b_e_r
  111.                Specifies which bit plane to use in an image.  The
  112.                default is to use the entire image and map values into
  113.                black and white based on color intensities.
  114.  
  115.           ----ggggrrrraaaayyyy  _2 | _3 | _4
  116.                Uses a simple 2x2, 3x3, or 4x4 gray scale conversion on
  117.                a color image, rather than mapping to strictly black
  118.                and white.  This doubles, triples, or quadruples the
  119.                effective width and height of the image.
  120.  
  121.           ----ppppoooorrrrttttrrrraaaaiiiitttt
  122.                Forces the window to be printed in portrait mode.  By
  123.                default a window is printed such that its longest side
  124.                follows the long side of the paper.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXPPPPRRRR((((1111))))              XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))               XXXXPPPPRRRR((((1111))))
  137.  
  138.  
  139.  
  140.           ----rrrrvvvv  Forces the window to be printed in reverse video.
  141.  
  142.           ----ccccoooommmmppppaaaacccctttt
  143.                Uses simple run-length encoding for compact
  144.                representation of windows with lots of white pixels.
  145.  
  146.           ----oooouuuuttttppppuuuutttt _f_i_l_e_n_a_m_e
  147.                Specifies an output file name.  If this option is not
  148.                specified, standard output is used.
  149.  
  150.           ----aaaappppppppeeeennnndddd _f_i_l_e_n_a_m_e
  151.                Specifies a filename previously produced by _x_p_r to
  152.                which the window is to be appended.
  153.  
  154.           ----nnnnooooffffffff
  155.                When specified in conjunction with ----aaaappppppppeeeennnndddd, the window
  156.                will appear on the same page as the previous window.
  157.  
  158.           ----sssspppplllliiiitttt _n
  159.                This option allows the user to split a window onto
  160.                several pages. This might be necessary for very large
  161.                windows that would otherwise cause the printer to
  162.                overload and print the page in an obscure manner.
  163.  
  164.           ----ppppssssffffiiiigggg
  165.                Suppress translation of the PostScript picture to the
  166.                center of the page.
  167.  
  168.           ----ddddeeeennnnssssiiiittttyyyy _d_p_i
  169.                Indicates what dot-per-inch density should be used by
  170.                the HP printer.
  171.  
  172.           ----ccccuuuuttttooooffffffff _l_e_v_e_l
  173.                Changes the intensity level where colors are mapped to
  174.                either black or white for monochrome output on a
  175.                LaserJet printer.  The _l_e_v_e_l is expressed as percentage
  176.                of full brightness.  Fractions are allowed.
  177.  
  178.           ----nnnnooooppppoooossssiiiittttiiiioooonnnn
  179.                This option causes header, trailer, and image
  180.                positioning command generation to be bypassed for
  181.                LaserJet, PaintJet and PaintJet XL printers.
  182.  
  183.           ----ggggaaaammmmmmmmaaaa _c_o_r_r_e_c_t_i_o_n
  184.                This changes the intensity of the colors printed by
  185.                PaintJet XL printer. The _c_o_r_r_e_c_t_i_o_n is a floating point
  186.                value in the range 0.00 to 3.00.  Consult the
  187.                operator's manual to determine the correct value for
  188.                the specific printer.
  189.  
  190.           ----rrrreeeennnnddddeeeerrrr _a_l_g_o_r_i_t_h_m
  191.                This allows PaintJet XL printer to render the image
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXPPPPRRRR((((1111))))              XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))               XXXXPPPPRRRR((((1111))))
  203.  
  204.  
  205.  
  206.                with the best quality versus performance tradeoff.
  207.                Consult the operator's manual to determine which
  208.                _a_l_g_o_r_i_t_h_ms are available.
  209.  
  210.           ----sssslllliiiiddddeeee
  211.                This option allows overhead transparencies to be
  212.                printed using the PaintJet and PaintJet XL printers.
  213.  
  214.  
  215.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  216.           xwd(1), xwud(1), X(1)
  217.  
  218.      LLLLIIIIMMMMIIIITTTTAAAATTTTIIIIOOOONNNNSSSS
  219.           The current version of _x_p_r can generally print out on the
  220.           LN03 most X windows that are not larger than two-thirds of
  221.           the screen.  For example, it will be able to print out a
  222.           large Emacs window, but it will usually fail when trying to
  223.           print out the entire screen.  The LN03 has memory
  224.           limitations that can cause it to incorrectly print very
  225.           large or complex windows.  The two most common errors
  226.           encountered are ``band too complex'' and ``page memory
  227.           exceeded.''  In the first case, a window may have a
  228.           particular six pixel row that contains too many changes
  229.           (from black to white to black).  This will cause the printer
  230.           to drop part of the line and possibly parts of the rest of
  231.           the page.  The printer will flash the number `1' on its
  232.           front panel when this problem occurs.  A possible solution
  233.           to this problem is to increase the scale of the picture, or
  234.           to split the picture onto two or more pages.  The second
  235.           problem, ``page memory exceeded,'' will occur if the picture
  236.           contains too much black, or if the picture contains complex
  237.           half-tones such as the background color of a display.  When
  238.           this problem occurs the printer will automatically split the
  239.           picture into two or more pages.  It may flash the number `5'
  240.           on its from panel.  There is no easy solution to this
  241.           problem.  It will probably be necessary to either cut and
  242.           paste, or to rework the application to produce a less
  243.           complex picture.
  244.  
  245.           There are several limitations on the LA100 support:  the
  246.           picture will always be printed in portrait mode, there is no
  247.           scaling, and the aspect ratio will be slightly off.
  248.  
  249.           Support for PostScript output currently cannot handle the
  250.           ----aaaappppppppeeeennnndddd, ----nnnnooooffffffff or ----sssspppplllliiiitttt options.
  251.  
  252.           The ----ccccoooommmmppppaaaacccctttt option is _o_n_l_y supported for PostScript output.
  253.           It compresses white space but not black space, so it is not
  254.           useful for reverse-video windows.
  255.  
  256.           For color images, xpr should map directly to PostScript
  257.           image support, but it doesn't.
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 10/3/02)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXPPPPRRRR((((1111))))              XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))               XXXXPPPPRRRR((((1111))))
  269.  
  270.  
  271.  
  272.      HHHHPPPP PPPPRRRRIIIINNNNTTTTEEEERRRRSSSS
  273.           If no ----ddddeeeennnnssssiiiittttyyyy is specified on the command line 300 dots per
  274.           inch will be assumed for _l_j_e_t and 90 dots per inch for _p_j_e_t.
  275.           Allowable _d_e_n_s_i_t_y values for a LaserJet printer are 300,
  276.           150, 100, and 75 dots per inch.  Consult the operator's
  277.           manual to determine densities supported by other printers.
  278.  
  279.           If no ----ssssccccaaaalllleeee is specified the image will be expanded to fit
  280.           the printable page area.
  281.  
  282.           The default printable page area is 8x10.5 inches. Other
  283.           paper sizes can be accommodated using the ----hhhheeeeiiiigggghhhhtttt and ----wwwwiiiiddddtttthhhh
  284.           options.
  285.  
  286.           Note that a 1024x768 image fits the default printable area
  287.           when processed at 100 dpi with scale=1, the same image can
  288.           also be printed using 300 dpi with scale=3 but will require
  289.           considerably more data be transferred to the printer.
  290.  
  291.           _x_p_r may be tailored for use with monochrome PCL printers
  292.           other than the LaserJet.  To print on a ThinkJet (HP2225A)
  293.           _x_p_r could be invoked as:
  294.  
  295.               xpr -density 96 -width 6.667 _f_i_l_e_n_a_m_e
  296.  
  297.           or for black-and-white output to a PaintJet:
  298.  
  299.               xpr -density 180 _f_i_l_e_n_a_m_e
  300.  
  301.           The monochrome intensity of a pixel is computed as 0.30*R +
  302.           0.59*G + 0.11*B.  If a pixel's computed intensity is less
  303.           than the ----ccccuuuuttttooooffffffff level it will print as white.  This maps
  304.           light-on-dark display images to black-on-white hardcopy.
  305.           The default cutoff intensity is 50% of full brightness.
  306.           Example: specifying ----ccccuuuuttttooooffffffff 88887777....5555 moves the white/black
  307.           intensity point to 87.5% of full brightness.
  308.  
  309.           A LaserJet printer must be configured with sufficient memory
  310.           to handle the image.  For a full page at 300 dots per inch
  311.           approximately 2MB of printer memory is required.
  312.  
  313.           Color images are produced on the PaintJet at 90 dots per
  314.           inch.  The PaintJet is limited to sixteen colors from its
  315.           330 color palette on each horizontal print line.  _x_p_r will
  316.           issue a warning message if more than sixteen colors are
  317.           encountered on a line.  _x_p_r will program the PaintJet for
  318.           the first sixteen colors encountered on each line and use
  319.           the nearest matching programmed value for other colors
  320.           present on the line.
  321.  
  322.           Specifying the ----rrrrvvvv, reverse video, option for the PaintJet
  323.           will cause black and white to be interchanged on the output
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 10/3/02)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXPPPPRRRR((((1111))))              XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))               XXXXPPPPRRRR((((1111))))
  335.  
  336.  
  337.  
  338.           image.  No other colors are changed.
  339.  
  340.           Multiplane images must be recorded by _x_w_d in _Z_P_i_x_m_a_p format.
  341.           Single plane (monochrome) images may be in either _X_Y_P_i_x_m_a_p
  342.           or _Z_P_i_x_m_a_p format.
  343.  
  344.           Some PCL printers do not recognize image positioning
  345.           commands.  Output for these printers will not be centered on
  346.           the page and header and trailer strings may not appear where
  347.           expected.
  348.  
  349.           The ----ggggaaaammmmmmmmaaaa and ----rrrreeeennnnddddeeeerrrr options are supported only on the
  350.           PaintJet XL printers.
  351.  
  352.           The ----sssslllliiiiddddeeee option is not supported for LaserJet printers.
  353.  
  354.           The ----sssspppplllliiiitttt option is not supported for HP printers.
  355.  
  356.           The ----ggggrrrraaaayyyy option is not supported for HP or IBM printers.
  357.  
  358.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  359.           Copyright 1988, Massachusetts Institute of Technology.
  360.           Copyright 1986, Marvin Solomon and the University of
  361.           Wisconsin.
  362.           Copyright 1988, Hewlett Packard Company.
  363.           See _X(_1) for a full statement of rights and permissions.
  364.  
  365.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  366.           Michael R. Gretzinger, MIT Project Athena, Jose Capo, MIT
  367.           Project Athena (PP3812 support), Marvin Solomon, University
  368.           of Wisconsin, Bob Scheifler, MIT, Angela Bock and E. Mike
  369.           Durbin, Rich Inc. (grayscale), Larry Rupp, HP (HP printer
  370.           support).
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 10/3/02)
  394.  
  395.  
  396.  
  397.